home *** CD-ROM | disk | FTP | other *** search
/ Internet Warrior 1993 July / Internet Warrior No. 1 July 1993 - Austin Code Works.ISO / apps / pcgopher / readme.pc < prev    next >
Encoding:
Text File  |  1993-04-11  |  9.0 KB  |  202 lines
  1. ------------------------------------------------------------------------------
  2.          __________   __________   __________   __________   ________
  3.         /  _______/  /  ____   /  /  _______/  /  _______/  /  ____  \
  4.        /  / _____   /  /   /  /  /  /______   /  /______   /  /___/  /
  5.       /  / /_   /  /  /   /  /  /  _______/  /  _______/  /  __   __/
  6.      /  /___/  /  /  /___/  /  /  /         /  /______   /  /  \  \ 
  7.     /_________/  /_________/  /__/         /_________/  /__/    \__\
  8.  
  9.    Functional programming environment, Version 2.28
  10.  
  11.    README file for Gofer version 2.28, prepared for PC compatibles.
  12.  
  13.    Copyright Mark P Jones 1991-1993.
  14.  
  15.             CONDITIONS OF USE, DUPLICATION AND DISTRIBUTION
  16.  
  17.     -----------------------------------------------------------------------    
  18.     Permission to use, copy, modify, and distribute this software and its
  19.     documentation for any personal or educational use without fee is hereby
  20.     granted, provided that:
  21.      a) This copyright notice is retained in both source code and
  22.         supporting documentation.
  23.      b) Modified versions of this software are redistributed only if
  24.         accompanied by a complete history (date, author, description) of
  25.         modifications made; the intention here is to give appropriate
  26.         credit to those involved, whilst simultaneously ensuring that any
  27.         recipient can determine the origin of the software.
  28.      c) The same conditions are also applied to any software system
  29.         derived either in full or in part from Gofer.
  30.  
  31.     The name "Gofer" is not a trademark, registered or otherwise, and you
  32.     are free to mention this name in published material, public and private
  33.     correspondence, or other documents without restriction or obligation.
  34.  
  35.     Gofer is provided "as is" without express or implied warranty.
  36.     -----------------------------------------------------------------------
  37.  
  38.  
  39. These notes outline the use of the standard PC version of Gofer 2.28.
  40. If you have a 80386 based machine (or better) you will probably prefer
  41. to use the alternative version of Gofer in 386gofer.zip, which makes
  42. better use of the facilities provided by such machines.
  43.  
  44. INTRODUCTION:
  45. -------------
  46. Gofer is a functional programming language, closely related to Haskell, and
  47. includes the following features:
  48.  
  49.   o  Lazy evaluation, higher order functions, pattern matching etc...
  50.  
  51.   o  Wide range of built-in types with provision for defining new free
  52.      datatypes and type synonyms.
  53.  
  54.   o  Polymorphic type system with provision for overloading based on
  55.      a system of type classes.
  56.  
  57.   o  Full Haskell 1.2 expression and pattern syntax including lambda,
  58.      case, conditional and let expressions, list comprehensions, operator
  59.      sections, and wildcard, as and irrefutable patterns.
  60.  
  61.   o  Partial implementation of Haskell 1.2 facilities for I/O, enabling
  62.      the use of simple interactive programs and programs reading and writing
  63.      text files.
  64.  
  65.   o  User documentation, sample programs and source code freely available.
  66.  
  67.   o  Runs (and originally developed) on PC compatible computers, but
  68.      also works on Sun workstations.  Code should be portable to many
  69.      other kinds of machine.
  70.  
  71. INSTALLATION:
  72. -------------
  73. In order to use this package, you should make a Gofer directory:
  74.  
  75.      C:\> mkdir Gofer
  76.      C:\> cd Gofer
  77.  
  78. Unzip the PCGOF228 archive using either PKUNZIP or the INFO-ZIP unzip
  79. utility (don't forget the -d option if you use PKUNZIP):
  80.  
  81.      C:\GOFER> pkunzip -d pcgof228
  82.  
  83. or, using the INFO-ZIP equivalent:
  84.  
  85.      C:\GOFER> unzip pcgof228
  86.  
  87. (If you don't have either utility already, run the program unz50p1.exe
  88. supplied in the standard distribution; it is a self-extracting archive
  89. containing the INFO-ZIP utility).
  90.  
  91. Move the file GOFER.EXE to a suitable directory somewhere on your path
  92. (or add C:\GOFER to the end of your path in AUTOEXEC.BAT).  I have taken
  93. every precaution to try and ensure that the version of GOFER.EXE that
  94. you have received is free from virus infection, but I cannot make any
  95. guarantees.  As with all software distributed in this way, you should
  96. take the appropriate precuations to protect yourself and your computer
  97. system.  Full source code is available for those who wish to use Gofer
  98. in an environment where the use of external binary files is not generally
  99. allowed.
  100.  
  101. You will need to set the environment variable GOFER to the name of the
  102. prelude file that you want to use.  Either:
  103.  
  104.      C:\GOFER> set GOFER=C:\GOFER\standard.prelude
  105.  
  106. if you want to use the full Gofer prelude, or:
  107.  
  108.      C:\GOFER> set GOFER=C:\GOFER\simple.prelude
  109.  
  110. if you would rather use the simplified prelude (without support for
  111. overloading).  If you intend to use Gofer frequently, it would probably
  112. be sensible to include one of these lines in your AUTOEXEC.BAT file.
  113. Note that some of the demonstration programs may not work correctly with
  114. the simple prelude.
  115.  
  116. [Even though DOS only treats the first three characters after the
  117. period as significant, you must type in the prelude name with a full
  118. .prelude extension.  Setting the prelude name to \GOFER\standard.PRE
  119. will not always work as you might expect.]
  120.  
  121. You may wish to use an editor program from within Gofer.  You will probably
  122. need to choose a fairly small editor, since the space available once Gofer
  123. is loaded will be fairly limited.  In the past, I have recommended the use
  124. of Calvin 2.1, a free vi-clone.  To make proper use of the editor you will
  125. need to set the environment variables EDITOR and EDITLINE.  The appropriate
  126. settings for Calvin are:
  127.  
  128.      C:\GOFER> set EDITOR=vi
  129.      C:\GOFER> set EDITLINE=vi +%d %s
  130.  
  131. (these settings are actually builtin to this version of GOFER as defaults,
  132. but should give you an idea of the way these variables should be used).
  133.  
  134. These lines can also be placed in your AUTOEXEC.BAT. The %d and %s characters
  135. in EDITLINE indicate the line number and filename which is to be edited.
  136. These fields may appear in either order in EDITLINE to support different
  137. editors.  If your editor does not support this feature, you should set
  138. EDITLINE and EDITOR to be the same (not involving %s or %d). It is
  139. particularly nice if you can find an editor that supports starting at a
  140. given line since, should an error be detected in your programs, Gofer will
  141. be able to start the editor at (or close to) the line that caused the
  142. problem.
  143.  
  144. A copy of the user documentation for Gofer (in either plain ASCII or LaTeX
  145. formats) should be available at the same site where you obtained this
  146. package, together with the full source code for Gofer.
  147.  
  148. The DEMOS subdirectory contains a number of sample Gofer programs for
  149. use on the PC.  Change to this directory and use the project file
  150. demoproj to try out some of these programs: (start Gofer with the
  151. command GOFER + demoproj, or give the command :p demoproj from within
  152. the interpreter).  You will also find the code for Simon Peyton Jones
  153. and David Lester's fully modular lambda lifter in Haskell ... well,
  154. Gofer actually in DEMOS\MODULAR, and the code for my own Mini Prolog
  155. interpreter in Gofer in DEMOS\PROLOG.  See the appropriate README
  156. files for details.
  157.  
  158. REQUIREMENTS:
  159. -------------
  160. This version of Gofer has been prepared for use with PC compatibles running
  161. DOS.  This version will run on any machine with 640K of RAM (or more) running
  162. DOS 3.x or above.  No special hardware (e.g mouse or graphics adapter) is
  163. required.  You do not need a 286, 386 or 486 to run Gofer, although it is
  164. obviously best to use a faster machine if you have one.  No matter how
  165. powerful your machine, this version of Gofer is limited to using 640K of RAM.
  166.  
  167. You might also be able to run this version of Gofer on machines with 512K,
  168. but you will probably need to set a smaller heap size.  Try starting Gofer
  169. with a command line of the form:
  170.  
  171.          GOFER -h12000
  172.  
  173. where 12000 is the number of cells that will be provided by the heap.
  174. This number may need to be adjusted either up or down to suit your
  175. configuration.
  176.  
  177. If things are really tight, you might need to get a copy of the source and
  178. recompile without floating point support.  Alternatively, you can use the
  179. old PC version 2.23 which is smaller (but also has a few bugs compared to
  180. the newest version).
  181.  
  182.  
  183. FURTHER INFORMATION:
  184. --------------------
  185. If you would like to keep up to date with future developments, bugfixes and
  186. enhancements to Gofer and have not already contacted me, please email me at
  187. jones-mark@cs.yale.edu and I will add your name to my mailing list.
  188.  
  189. You should also be able to contact my directly at the Department of
  190. Computer Science, Yale University, Box 2158 Yale Station, New Haven, CT
  191. 06520, USA.  I regret that I do not have the resources to maintain a
  192. mailing list for those without access to electronic mail facilities.
  193. In addition, my response to written correspondence is likely to be much
  194. slower than responses to email.
  195.  
  196. Please do not hesitate to contact me if you have any questions or
  197. suggestions about the Gofer system. 
  198.  
  199. Enjoy!
  200. Mark
  201. ------------------------------------------------------------------------------
  202.